home *** CD-ROM | disk | FTP | other *** search
/ Ham Radio 2000 #2 / Ham Radio 2000 - Volume 2.iso / HAMV2 / PACKET / TFLINK10 / README < prev    next >
Encoding:
Text File  |  1996-11-04  |  5.0 KB  |  120 lines
  1. TFLINK 1.0 Archive Notes - G0FRD, 4th Nov 1996
  2. ----------------------------------------------
  3.  
  4. Introduction
  5. ------------
  6.  
  7. TFLINK is a DOS program to allow a DOS PC running TFPCX (or
  8. equivalent) to emulate a packet radio TNC on behalf of another host
  9. computer system (for example, Linux).  It does the much same job as
  10. PCTNC (DG3VT/DL2ECK), and TNCEMU (EB7CJO).  Unlike both of these,
  11. however, TFLINK is a TSR program, so you can do other things on the PC
  12. that is emulating a TNC (for example, play Tetris).
  13.  
  14.  
  15. Archive contents
  16. ----------------
  17.  
  18. The TFLINK10.ZIP archive contains two further zipped archives;
  19. TFLNKBIN.ZIP, and TFLNKSRC.ZIP.
  20.  
  21. TFLNKBIN.ZIP contains the TFLINK.EXE TSR program itself, a minimal
  22. documentation file TFLINK.DOC, and a test program TFTERM, which you
  23. can use if you intend to use Linux (or a closely related UNIX) as the
  24. host system to connect to your TNC-emulating DOS PC.
  25.  
  26. TFLNKSRC.ZIP contains full 'C' source code and a makefile to build
  27. TFLINK.EXE.  As my DOS system has expired, it is unlikely that I will
  28. be developing TFLINK any further, so if you want to take the source
  29. and use it, modify it for your own ends, or improve it, then here it
  30. is.  The original was built with Borland Turbo-C.
  31.  
  32.  
  33. Additional notes on running TFLINK.EXE
  34. --------------------------------------
  35.  
  36. On slower DOS systems (286 12MHz is the slowest I have), I found that
  37. I had problems running just TFPCX on the system, and that TFLINK and
  38. TFPCX would not coexist at all.  This was tested with several versions
  39. of DOS, from 3.3 to 6.2, with no major differences.  The symptoms were
  40. that the system would either lock, or print some form of overflow
  41. message and then lock.  The solution was to use a lighter-weight form
  42. of TFPCX - TFX_UART version 2.7 from the TFX.ZIP archive worked fine
  43. on all test systems (the only noticable difference is that it reports
  44. itself as version 82.7 rather than 2.7 when queried by TFLINK).
  45.  
  46. TFLINK requires only three lines in the serial cable to be connected -
  47. TXd, RXd, and Ground.
  48.  
  49. The undocumented -R flag sets TFLINK to read-only mode; that is, it
  50. will send characters from TFPCX to the host system, but not from the
  51. host system to TFPCX.  This was to effectively disable transmit when
  52. testing, but since this also inhibits TFPCX setup commands such as "m
  53. uisc" from being sent from the host system, it isn't all that useful.
  54.  
  55. On Linux (if you have it), TFTERM behaves better in a standard
  56. multiscreen that it does in an X window.  This is probably something
  57. to do with the way it manipulates stty settings.  It's only a test
  58. program, in any case.
  59.  
  60. TFLINK has only been tested with Tnt (version 0.9l) under Linux.  It
  61. should however also work with other non-Baycom terminal program and
  62. operating system combinations, since it enables emulation of a general
  63. purpose and hostmode TNC.
  64.  
  65.  
  66. Further work on TFLINK
  67. ----------------------
  68.  
  69. The unload command is rather haphazard.  It should really use a DOS
  70. INT to communicate to the TSR that it should terminate, but in fact it
  71. just sets a bit in the PIC chip to 'unlock' the serial port, relying
  72. on the background TSR to spot this at the next timer interrupt.  The
  73. 'foreground' TFLINK doesn't even check that the TSR has in fact
  74. unloaded - it just assumes everything will be fine.
  75.  
  76. When the TSR terminates, it doesn't check to see if another TSR has
  77. been loaded after it that may have redirected one if its vectors. 
  78. This can result in a system crash if you don't unload any TSRs loaded
  79. after TFLINK, before unloading TFLINK itself.
  80.  
  81. Too much code is held resident in the TSR.  For example, the command
  82. line argument processing can be discarded just before the program
  83. installs itself as a TSR; this will save memory.
  84.  
  85. Flow control on the serial link to/from TFLINK is something that
  86. hasn't been full investigated (happily, the WA8DED hostmode protocol
  87. seems to take care of most of this, though).
  88.  
  89. A foreground debugging/tracing mode for TFLINK.EXE would be nice.
  90.  
  91. After all the messing about with UART and PIC registers, creating a
  92. TSR, etc, is done with, the program is embarassingly simple.
  93.  
  94.  
  95. Disclaimer
  96. ----------
  97.  
  98. TFLINK.EXE and its source code are provided free of any charge for
  99. amateur and non-commercial use.  Within this constraint, you may do
  100. anything you like with the code except claim that you wrote it.
  101.  
  102. There's no warranty, or guarantee that it will do what you want, or
  103. even what it claims to do.
  104.  
  105.  
  106. Acknowledgements
  107. ----------------
  108.  
  109. Finally, thanks to the author and translator from Pascal to 'C' of the
  110. IBMCOM serial comms source code package, for doing over half of the
  111. work of TFLINK.
  112.  
  113.  
  114. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  115.  G0FRD               | AX25 BBS Packet  - G0FRD @ GB7BEN.#43.GBR.EU
  116.  Simon Baldwin       | AMPR.NET TCP/IP  - g0frd@g0frd.ampr.org
  117.  Leighton Buzzard    | INTERNET at work - simonb@sco.COM
  118.  Beds (IO91PV, SP92) | INTERNET at home - Probably never
  119. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  120.